Creating and Analyzing Trace Files with Toad for Oracle 


Oracle’s Trace technology allows you to record all of the SQL and underlying activity that happens during 
a user or program’s session in the database. There are many ways you Can initiate a trace, this 
document will show how to do so manually for a specific session. To read in detail about Trace and how 
to set this up automatically for a specific program, please read this. 


Requirements 
1. You have the TkProf utility installed on your local machine. This should be included in the full 
Oracle Client installation, and Toad should be able to find it if you have your ORACLE_ HOME 
directory set for your user. 
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2. You have access to the OS directory where the trace files reside. If your database runs on a Unix 
or remote Windows server, you'll need FTP access to this remote directory. 

3. You have access to the VSSESSION and related views in the data dictionary. This will allow you 
to use the Session Browser to find the session you want to trace. 

4. You have execute privileges granted for the SYS.DBMS_SYSTEM package. Toad uses this 
package to start and stop a trace. 


Finding the Session 

Toad’s Session Browser allows you to manage all of the current sessions (or connections) in the 
database. Assuming your program is already logged into the database, you can see what SQL they are 
generating, what SQL they have open as cursors, and start/stop a Trace for its session. 
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Once you have the Session Browser open you can then browse the sessions by several different 
groupings. Showing connections by user, OS user, or program are the most likely choices. 
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Once you select a session on the top, you can then see all of the detail information for that session in 
the bottom panes. The Current Statement and Open Cursors tabs will show you what SQL they are 
current running and which SQL statements are open as program cursors. 


If you want to record these SQL for the duration of the session, you need to start a trace. 


Starting the Trace 
With the session you want to monitor selected in the ‘Sessions’ tab, click on the ‘Start trace for theses 
sessions’ button. 
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This will open the ‘Start Trace’ dialog. From here you can choose to what level trace you want to do. 
Enabling the ‘Include Binds’ will cause Oracle to track and record the values submitted in SQL 
statements that use Bind Parameters. If you want the context of these SQL statements including the 
values used, make sure to turn this on. Otherwise you will see the SQL but not the values used to 
populate the queries. 
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Now, while your program runs, Oracle will record the activity in a Trace File on the database server in 





the user_dump_dest directory. When you are ready to stop recording the activity, click the ‘Stop 
Trace...’ button. 


Analyzing the Trace Files 
Oracle provides a built-in utility to analyze trace files called TkProf. Toad provides an interface to TkProf 
so you do not have to learn the syntax required to run this command-line OS program. 
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Step 1: Find the Trace Files 
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You can navigate your local OS, or browse the UNIX server to find your trace files. Once found, select 
the trace files generated by your session. You can use the date/timestamp of the files to help you figure 
out which files to analyze. 


Choose Your Sort Order 

The next screen will ask you how you want the information displayed. Not choosing any options will 
display the queries exactly as they were executed. Choosing options will help you figure out which SQL 
was the most expensive for your session. 
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Other Options 

If you only want the top 5 SQL statements for the session, you can choose to limit the results of the 
trace using an option on the 3" step of the wizard. You will probably want to disable ‘Show recursive 
SQL statements.’ Recursive SQL is SQL that Oracle itself generates to help with the requests of your 
session. 
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Viewing the Trace File Output 
Once you click on ‘Finish’ Toad will make a call to the TkProf program on your computer and show the 
results. 
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What’s Coming for Toad Version 9.7 

Analyzing Trace files with TkProf can be quite difficult. For this reason, starting with v9.7 of Toad, we 
will include an automated trace file advisor. It will show you the SQL in the trace file and automatically 
allow you to figure out what is causing a bottleneck and much more! Join our beta program at 


http://www.toadsoft.com/beta.html if you want to preview this feature today! 


The following screenshots show features not yet commercially available in Toad. These features could 
change dramatically before the product is released. Participation in the Beta Program is restricted to 
current commercial Toad users. 
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